saveAppointment

saveAppointment

Header Parameters

authorization string required

authorization

application/json

Request Body required

request

dealerDepartmentUuidList string[]
requesterUserUuid string
serviceAppointment object
appointmentKey string
appointmentType string
Possible values: [MOBILE_SERVICE, REGULAR_SERVICE]
assignedUser object
departmentUuid string
isMobileServiceTechnician boolean
isValid boolean
userUuid string
createdByUser object
departmentUuid string
isMobileServiceTechnician boolean
isValid boolean
userUuid string
createdTimeStamp date-time
customerUUID string
customerVehicleUUID string
dealerUUID string
destinationAddress string
destinationLatitude double
destinationLongitude double
emailPreference boolean
internalNotes string
lastMileage string
platform string
Possible values: [DEALER_APP, WEB, MOBILE_APP, DMS, TRANSPORTATION_EVENTS_CONSUMER]
preferredDate string
publicNotes string
quickOpList object[]
Array [
description string
laborOpCode string
opCodeDuration string
opCodeName string
quickOpLiteUUID string
totalPrice string
]
serviceAdvisor object
departmentUuid string
isMobileServiceTechnician boolean
isValid boolean
userUuid string
serviceEndTime string
serviceStartTime string
sprinterVehicleUUID string
status string
Possible values: [PENDING_APPROVAL, SCHEDULED, TRIP_IN_PROGRESS, TECHNICIAN_ARRIVED, SERVICE_IN_PROGRESS, SERVICE_COMPLETED, CANCELLED, COMPLETED, DECLINED]
textPreference boolean
uuid string

Responses

• 200
• 201
• 401
• 403
• 404

---

OK

application/json

Schema

Example (from schema)

---

Schema

appointmentUUID string
error object
code string
description string
metadata object
property name* string
statusCode int32
warnings object[]
Array [
code string
description string
]

{
  "appointmentUUID": "string",
  "error": {
    "code": "string",
    "description": "string",
    "metadata": {}
  },
  "statusCode": 0,
  "warnings": [
    {
      "code": "string",
      "description": "string"
    }
  ]
}

Created

Unauthorized

Forbidden

Not Found

PUT /appointment/save

Request

Base URL

//api.mykaarma.com/mobile-service

authorization — header required

Body required

{
  "dealerDepartmentUuidList": [
    "string"
  ],
  "requesterUserUuid": "string",
  "serviceAppointment": {
    "appointmentKey": "string",
    "appointmentType": "MOBILE_SERVICE",
    "assignedUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdByUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdTimeStamp": "2025-04-07T07:51:24.752Z",
    "customerUUID": "string",
    "customerVehicleUUID": "string",
    "dealerUUID": "string",
    "destinationAddress": "string",
    "destinationLatitude": 0,
    "destinationLongitude": 0,
    "emailPreference": true,
    "internalNotes": "string",
    "lastMileage": "string",
    "platform": "DEALER_APP",
    "preferredDate": "string",
    "publicNotes": "string",
    "quickOpList": [
      {
        "description": "string",
        "laborOpCode": "string",
        "opCodeDuration": "string",
        "opCodeName": "string",
        "quickOpLiteUUID": "string",
        "totalPrice": "string"
      }
    ],
    "serviceAdvisor": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "serviceEndTime": "string",
    "serviceStartTime": "string",
    "sprinterVehicleUUID": "string",
    "status": "PENDING_APPROVAL",
    "textPreference": true,
    "uuid": "string"
  }
}

curl / cURL

curl -L -X PUT '//api.mykaarma.com/mobile-service/appointment/save' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "dealerDepartmentUuidList": [
    "string"
  ],
  "requesterUserUuid": "string",
  "serviceAppointment": {
    "appointmentKey": "string",
    "appointmentType": "MOBILE_SERVICE",
    "assignedUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdByUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdTimeStamp": "2025-04-07T07:51:24.752Z",
    "customerUUID": "string",
    "customerVehicleUUID": "string",
    "dealerUUID": "string",
    "destinationAddress": "string",
    "destinationLatitude": 0,
    "destinationLongitude": 0,
    "emailPreference": true,
    "internalNotes": "string",
    "lastMileage": "string",
    "platform": "DEALER_APP",
    "preferredDate": "string",
    "publicNotes": "string",
    "quickOpList": [
      {
        "description": "string",
        "laborOpCode": "string",
        "opCodeDuration": "string",
        "opCodeName": "string",
        "quickOpLiteUUID": "string",
        "totalPrice": "string"
      }
    ],
    "serviceAdvisor": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "serviceEndTime": "string",
    "serviceStartTime": "string",
    "sprinterVehicleUUID": "string",
    "status": "PENDING_APPROVAL",
    "textPreference": true,
    "uuid": "string"
  }
}'

python / requests

curl -L -X PUT '//api.mykaarma.com/mobile-service/appointment/save' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "dealerDepartmentUuidList": [
    "string"
  ],
  "requesterUserUuid": "string",
  "serviceAppointment": {
    "appointmentKey": "string",
    "appointmentType": "MOBILE_SERVICE",
    "assignedUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdByUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdTimeStamp": "2025-04-07T07:51:24.752Z",
    "customerUUID": "string",
    "customerVehicleUUID": "string",
    "dealerUUID": "string",
    "destinationAddress": "string",
    "destinationLatitude": 0,
    "destinationLongitude": 0,
    "emailPreference": true,
    "internalNotes": "string",
    "lastMileage": "string",
    "platform": "DEALER_APP",
    "preferredDate": "string",
    "publicNotes": "string",
    "quickOpList": [
      {
        "description": "string",
        "laborOpCode": "string",
        "opCodeDuration": "string",
        "opCodeName": "string",
        "quickOpLiteUUID": "string",
        "totalPrice": "string"
      }
    ],
    "serviceAdvisor": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "serviceEndTime": "string",
    "serviceStartTime": "string",
    "sprinterVehicleUUID": "string",
    "status": "PENDING_APPROVAL",
    "textPreference": true,
    "uuid": "string"
  }
}'

go / native

curl -L -X PUT '//api.mykaarma.com/mobile-service/appointment/save' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "dealerDepartmentUuidList": [
    "string"
  ],
  "requesterUserUuid": "string",
  "serviceAppointment": {
    "appointmentKey": "string",
    "appointmentType": "MOBILE_SERVICE",
    "assignedUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdByUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdTimeStamp": "2025-04-07T07:51:24.752Z",
    "customerUUID": "string",
    "customerVehicleUUID": "string",
    "dealerUUID": "string",
    "destinationAddress": "string",
    "destinationLatitude": 0,
    "destinationLongitude": 0,
    "emailPreference": true,
    "internalNotes": "string",
    "lastMileage": "string",
    "platform": "DEALER_APP",
    "preferredDate": "string",
    "publicNotes": "string",
    "quickOpList": [
      {
        "description": "string",
        "laborOpCode": "string",
        "opCodeDuration": "string",
        "opCodeName": "string",
        "quickOpLiteUUID": "string",
        "totalPrice": "string"
      }
    ],
    "serviceAdvisor": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "serviceEndTime": "string",
    "serviceStartTime": "string",
    "sprinterVehicleUUID": "string",
    "status": "PENDING_APPROVAL",
    "textPreference": true,
    "uuid": "string"
  }
}'

nodejs / axios

curl -L -X PUT '//api.mykaarma.com/mobile-service/appointment/save' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "dealerDepartmentUuidList": [
    "string"
  ],
  "requesterUserUuid": "string",
  "serviceAppointment": {
    "appointmentKey": "string",
    "appointmentType": "MOBILE_SERVICE",
    "assignedUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdByUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdTimeStamp": "2025-04-07T07:51:24.752Z",
    "customerUUID": "string",
    "customerVehicleUUID": "string",
    "dealerUUID": "string",
    "destinationAddress": "string",
    "destinationLatitude": 0,
    "destinationLongitude": 0,
    "emailPreference": true,
    "internalNotes": "string",
    "lastMileage": "string",
    "platform": "DEALER_APP",
    "preferredDate": "string",
    "publicNotes": "string",
    "quickOpList": [
      {
        "description": "string",
        "laborOpCode": "string",
        "opCodeDuration": "string",
        "opCodeName": "string",
        "quickOpLiteUUID": "string",
        "totalPrice": "string"
      }
    ],
    "serviceAdvisor": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "serviceEndTime": "string",
    "serviceStartTime": "string",
    "sprinterVehicleUUID": "string",
    "status": "PENDING_APPROVAL",
    "textPreference": true,
    "uuid": "string"
  }
}'

ruby / Net::HTTP

curl -L -X PUT '//api.mykaarma.com/mobile-service/appointment/save' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "dealerDepartmentUuidList": [
    "string"
  ],
  "requesterUserUuid": "string",
  "serviceAppointment": {
    "appointmentKey": "string",
    "appointmentType": "MOBILE_SERVICE",
    "assignedUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdByUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdTimeStamp": "2025-04-07T07:51:24.752Z",
    "customerUUID": "string",
    "customerVehicleUUID": "string",
    "dealerUUID": "string",
    "destinationAddress": "string",
    "destinationLatitude": 0,
    "destinationLongitude": 0,
    "emailPreference": true,
    "internalNotes": "string",
    "lastMileage": "string",
    "platform": "DEALER_APP",
    "preferredDate": "string",
    "publicNotes": "string",
    "quickOpList": [
      {
        "description": "string",
        "laborOpCode": "string",
        "opCodeDuration": "string",
        "opCodeName": "string",
        "quickOpLiteUUID": "string",
        "totalPrice": "string"
      }
    ],
    "serviceAdvisor": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "serviceEndTime": "string",
    "serviceStartTime": "string",
    "sprinterVehicleUUID": "string",
    "status": "PENDING_APPROVAL",
    "textPreference": true,
    "uuid": "string"
  }
}'

csharp / RestSharp

curl -L -X PUT '//api.mykaarma.com/mobile-service/appointment/save' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "dealerDepartmentUuidList": [
    "string"
  ],
  "requesterUserUuid": "string",
  "serviceAppointment": {
    "appointmentKey": "string",
    "appointmentType": "MOBILE_SERVICE",
    "assignedUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdByUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdTimeStamp": "2025-04-07T07:51:24.752Z",
    "customerUUID": "string",
    "customerVehicleUUID": "string",
    "dealerUUID": "string",
    "destinationAddress": "string",
    "destinationLatitude": 0,
    "destinationLongitude": 0,
    "emailPreference": true,
    "internalNotes": "string",
    "lastMileage": "string",
    "platform": "DEALER_APP",
    "preferredDate": "string",
    "publicNotes": "string",
    "quickOpList": [
      {
        "description": "string",
        "laborOpCode": "string",
        "opCodeDuration": "string",
        "opCodeName": "string",
        "quickOpLiteUUID": "string",
        "totalPrice": "string"
      }
    ],
    "serviceAdvisor": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "serviceEndTime": "string",
    "serviceStartTime": "string",
    "sprinterVehicleUUID": "string",
    "status": "PENDING_APPROVAL",
    "textPreference": true,
    "uuid": "string"
  }
}'

php / cURL

curl -L -X PUT '//api.mykaarma.com/mobile-service/appointment/save' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "dealerDepartmentUuidList": [
    "string"
  ],
  "requesterUserUuid": "string",
  "serviceAppointment": {
    "appointmentKey": "string",
    "appointmentType": "MOBILE_SERVICE",
    "assignedUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdByUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdTimeStamp": "2025-04-07T07:51:24.752Z",
    "customerUUID": "string",
    "customerVehicleUUID": "string",
    "dealerUUID": "string",
    "destinationAddress": "string",
    "destinationLatitude": 0,
    "destinationLongitude": 0,
    "emailPreference": true,
    "internalNotes": "string",
    "lastMileage": "string",
    "platform": "DEALER_APP",
    "preferredDate": "string",
    "publicNotes": "string",
    "quickOpList": [
      {
        "description": "string",
        "laborOpCode": "string",
        "opCodeDuration": "string",
        "opCodeName": "string",
        "quickOpLiteUUID": "string",
        "totalPrice": "string"
      }
    ],
    "serviceAdvisor": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "serviceEndTime": "string",
    "serviceStartTime": "string",
    "sprinterVehicleUUID": "string",
    "status": "PENDING_APPROVAL",
    "textPreference": true,
    "uuid": "string"
  }
}'

java / OkHttp

curl -L -X PUT '//api.mykaarma.com/mobile-service/appointment/save' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "dealerDepartmentUuidList": [
    "string"
  ],
  "requesterUserUuid": "string",
  "serviceAppointment": {
    "appointmentKey": "string",
    "appointmentType": "MOBILE_SERVICE",
    "assignedUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdByUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdTimeStamp": "2025-04-07T07:51:24.752Z",
    "customerUUID": "string",
    "customerVehicleUUID": "string",
    "dealerUUID": "string",
    "destinationAddress": "string",
    "destinationLatitude": 0,
    "destinationLongitude": 0,
    "emailPreference": true,
    "internalNotes": "string",
    "lastMileage": "string",
    "platform": "DEALER_APP",
    "preferredDate": "string",
    "publicNotes": "string",
    "quickOpList": [
      {
        "description": "string",
        "laborOpCode": "string",
        "opCodeDuration": "string",
        "opCodeName": "string",
        "quickOpLiteUUID": "string",
        "totalPrice": "string"
      }
    ],
    "serviceAdvisor": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "serviceEndTime": "string",
    "serviceStartTime": "string",
    "sprinterVehicleUUID": "string",
    "status": "PENDING_APPROVAL",
    "textPreference": true,
    "uuid": "string"
  }
}'

powershell / RestMethod

curl -L -X PUT '//api.mykaarma.com/mobile-service/appointment/save' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "dealerDepartmentUuidList": [
    "string"
  ],
  "requesterUserUuid": "string",
  "serviceAppointment": {
    "appointmentKey": "string",
    "appointmentType": "MOBILE_SERVICE",
    "assignedUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdByUser": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "createdTimeStamp": "2025-04-07T07:51:24.752Z",
    "customerUUID": "string",
    "customerVehicleUUID": "string",
    "dealerUUID": "string",
    "destinationAddress": "string",
    "destinationLatitude": 0,
    "destinationLongitude": 0,
    "emailPreference": true,
    "internalNotes": "string",
    "lastMileage": "string",
    "platform": "DEALER_APP",
    "preferredDate": "string",
    "publicNotes": "string",
    "quickOpList": [
      {
        "description": "string",
        "laborOpCode": "string",
        "opCodeDuration": "string",
        "opCodeName": "string",
        "quickOpLiteUUID": "string",
        "totalPrice": "string"
      }
    ],
    "serviceAdvisor": {
      "departmentUuid": "string",
      "isMobileServiceTechnician": true,
      "isValid": true,
      "userUuid": "string"
    },
    "serviceEndTime": "string",
    "serviceStartTime": "string",
    "sprinterVehicleUUID": "string",
    "status": "PENDING_APPROVAL",
    "textPreference": true,
    "uuid": "string"
  }
}'